home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / src / fileutil / giftrans.tar.gz / giftrans.tar / giftrans / giftrans.man < prev    next >
Text File  |  1996-09-03  |  9KB  |  265 lines
  1.  
  2.  
  3.  
  4.      GGGGIIIIFFFFTTTTRRRRAAAANNNNSSSS((((llll))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((llllooooccccaaaallll))))           GGGGIIIIFFFFTTTTRRRRAAAANNNNSSSS((((llll))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           giftrans - transform gif from gif87 to gif89, making one
  10.           color transparent
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ggggiiiiffffttttrrrraaaannnnssss [_o_p_t_i_o_n_s] [[[[-o _f_i_l_e_n_a_m_e]]]] ffffiiiilllleeeennnnaaaammmmeeee
  14.  
  15.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.           ggggiiiiffffttttrrrraaaannnnssss converts any GIF file into a GIF89a.  Allows for
  17.           setting the transparent or background color, changing
  18.           colors, adding or removing comments. Also code to analyze
  19.           GIF contents.
  20.  
  21.      OOOOPPPPTTTTIIIIOOOONNNNSSSS
  22.           -h   Print short help on stdout.
  23.  
  24.           -t   Specify the transparent color
  25.  
  26.           -T   Index of the transparent color is the background color
  27.                index
  28.  
  29.           -B   Specify the transparent color's new value
  30.  
  31.           -b   Specify the background color
  32.  
  33.           -g   Change a color in the global color table
  34.  
  35.           -c   Add a comment
  36.  
  37.           -C   Remove old comment
  38.  
  39.           -l   Only list the color table
  40.  
  41.           -L   Verbose output of GIFs contents
  42.  
  43.           -V   Verbose output while converting
  44.  
  45.           -o   Redirect stdout to a file
  46.  
  47.           -e   Redirect stderr to a file
  48.  
  49.           Colors may be specified as index, as rgb.txt entry or in the
  50.           #rrggbb form.
  51.  
  52.      EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  53.           To convert the white background of a gif file to
  54.           transparent, use
  55.  
  56.                giftrans -t #ffffff file.gif > transparentfile.gif
  57.  
  58.      BBBBUUUUGGGGSSSS
  59.           This program has been tested on a HP9000/720 with HP-UX
  60.  
  61.  
  62.  
  63.      Page 1                                           (printed 9/3/96)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      GGGGIIIIFFFFTTTTRRRRAAAANNNNSSSS((((llll))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((llllooooccccaaaallll))))           GGGGIIIIFFFFTTTTRRRRAAAANNNNSSSS((((llll))))
  71.  
  72.  
  73.  
  74.           A.08.07 In this environment, neither lint -u nor gcc -Wall
  75.           produce any messages.  If you encounter any errors or need
  76.           to make any changes to port it to another platform, please
  77.           contact me.
  78.  
  79.           Known bugs:
  80.  
  81.                -B flag won't work if there's an Extension between the
  82.                Global Color Table and the Image Descriptor (or Graphic
  83.                Control Extension). If -V has been specified, a Warning
  84.                Message will be displayed.  Will be fixed in 2.0
  85.  
  86.                Always outputs GIF89a. Shouldn't do this if version is
  87.                newer.
  88.  
  89.                -D option may output changed data instead of original
  90.                data, use with caution, best only with then -L option.
  91.  
  92.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  93.           Copyright (c) 24.2.94 by Andreas Ley <ley@rz.uni-
  94.           karlsruhe.de>
  95.  
  96.           Permission to use, copy, modify, and distribute this
  97.           software for any purpose and without fee is hereby granted,
  98.           provided that the above copyright notice appears in all
  99.           copies. This software is provided "as is" and without any
  100.           express or implied warranties.
  101.  
  102.      VVVVEEEERRRRSSSSIIIIOOOONNNN HHHHIIIISSSSTTTTOOOORRRRYYYY
  103.           Version 1.11 - 21.7.94
  104.                Moved Plain Text Extension to the Extensions section
  105.                where it belongs
  106.                Accept Unknown Extension Labels
  107.                Incorporated MS-DOS port by enzo@hk.net (Enzo
  108.                Michelangeli)
  109.                Added -o and -e options to redirect stdout and stderr
  110.                Added -D debug flag
  111.  
  112.           Version 1.10.2 - 22.6.94
  113.                Support for -DRGBTXT flag
  114.  
  115.           Version 1.10.1 - 21.6.94
  116.                Different rgb.txt file FreeBSD/386BSD
  117.  
  118.           Version 1.10 - 19.6.94
  119.                Added option to change a color in the global color
  120.                table
  121.                Added option to change the color for the transparent
  122.                color index
  123.  
  124.           Version 1.9.1 - 7.6.94
  125.                Different rgb.txt files for X11 and Open Windows
  126.  
  127.  
  128.  
  129.      Page 2                                           (printed 9/3/96)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      GGGGIIIIFFFFTTTTRRRRAAAANNNNSSSS((((llll))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((llllooooccccaaaallll))))           GGGGIIIIFFFFTTTTRRRRAAAANNNNSSSS((((llll))))
  137.  
  138.  
  139.  
  140.           Version 1.9 - 1.6.94
  141.                Fixed a bug which caused color names to be rejected.
  142.  
  143.           Version 1.8 - 30.5.94
  144.                Accept #rrggbb style arguments.
  145.                Do nothing if rgb-color not found in GIF.
  146.  
  147.           Version 1.7 - 16.5.94
  148.                Added -l option to only list the color table.
  149.                Added -L option for verbose output without creating a
  150.                gif.  Added -b option to change the background color
  151.                index.
  152.                Display all matching color names for color table
  153.                entries.
  154.                Fixed a bug which caused bad color names if rgb.txt
  155.                starts with whitespace.
  156.                Doesn't use strdup anymore.
  157.                Fixed =& bug on dec machines.
  158.  
  159.           Version 1.6 - 5.4.94
  160.                Added color names recognition.
  161.  
  162.           Version 1.5 - 15.3.94
  163.                Added basic verbose output to analyze GIFs.
  164.  
  165.           Version 1.4 - 8.3.94
  166.                Fixed off-by-one bug in Local Color table code.
  167.                Added option to add or remove a comment.
  168.                Transparency is no longer the default.
  169.  
  170.           This man file made 9.8 from documentation in the program
  171.           source code by Kai Nordlund (knordlun@fltxa.helsinki.fi).
  172.  
  173.      TTTTHHHHAAAANNNNKKKKSSSS
  174.           Thanx for bug reports, ideas and fixes to
  175.  
  176.                patricka@cs.kun.nl (Patrick Atoon)
  177.  
  178.                wes@msc.edu (Wes Barris)
  179.  
  180.                pmfitzge@ingr.com (Patrick M. Fitzgerald)
  181.  
  182.                hoesel@chem.rug.nl (frans van hoesel)
  183.  
  184.                boardman@jerry.sal.wisc.edu (Dan Boardman)
  185.  
  186.                krweiss@chip.ucdavis.edu (Ken Weiss)
  187.  
  188.                chuck@trantor.harris-atd.com (Chuck Musciano)
  189.  
  190.                heycke@camis.stanford.edu (Torsten Heycke)
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                           (printed 9/3/96)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      GGGGIIIIFFFFTTTTRRRRAAAANNNNSSSS((((llll))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((llllooooccccaaaallll))))           GGGGIIIIFFFFTTTTRRRRAAAANNNNSSSS((((llll))))
  203.  
  204.  
  205.  
  206.                claw@spacsun.rice.edu (Colin Law)
  207.  
  208.                jwalker@eos.ncsu.edu (Joseph C. Walker)
  209.  
  210.                Bjorn.Borud@alkymi.unit.no (Bjorn Borud)
  211.  
  212.                Christopher.Vance@adfa.oz.au (CJS Vance)
  213.  
  214.                pederl@norway.hp.com (Peder Langlo)
  215.  
  216.                I.Rutson@bradford.ac.uk (Ian Rutson)
  217.  
  218.                Nicolas.Pioch@enst.fr (Nicolas Pioch)
  219.  
  220.                john@charles.CS.UNLV.EDU (John Kilburg)
  221.  
  222.                enzo@hk.net (Enzo Michelangeli)
  223.  
  224.      DDDDIIIISSSSTTTTRRRRIIIIBBBBUUUUTTTTIIIIOOOONNNN
  225.           Original distribution site is
  226.                ftp://ftp.rz.uni-
  227.                karlsruhe.de/pub/net/www/tools/giftrans.c
  228.  
  229.           To compile for MS-DOS, you need getopt:
  230.                ftp://ftp.rz.uni-
  231.                karlsruhe.de/pub/net/www/tools/getopt.c
  232.  
  233.           MS-DOS executable can be found at
  234.                ftp://ftp.rz.uni-
  235.                karlsruhe.de/pub/net/www/tools/giftrans.exe
  236.  
  237.      at
  238.           A template rgb.txt for use with the MS-
  239.                DOS version can be found
  240.                ftp://ftp.rz.uni-karlsruhe.de/pub/net/www/tools/rgb.txt
  241.  
  242.           Additional info can be found on
  243.                http://melmac.corp.harris.com/transparent_images.html
  244.  
  245.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  246.           xv(1), giftoppm(1), ppmtogif(1)
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                           (printed 9/3/96)
  262.  
  263.  
  264.  
  265.